格式规范语法：`printf` 和 `wprintf` 函数

各种 printf 和 wprintf 函数采用格式字符串和可选参数，并生成用于输出的格式化字符序列。 格式字符串包含零个或多个指令，这些指令是用于输出的文本字符或描述如何在输出中设置参数格式的已编码的转换规范。 本文介绍用于对格式字符串中的转换规范进行编码的语法。 有关这些函数的列表，请参阅流 I/O。

一个转换规范由以下形式的可选和必需字段组成：

%[标志][宽度][.精度][大小]类型

转换规范的每个字段都是一个用于指示特定的格式选项或转换说明符的字符或数字。 必填的类型字段指定要应用于参数的转换类型。 可选的 标志、 宽度和 精度 字段控制其他格式方面，例如前导空格或零、对齐和显示的精度。 大小字段指定使用和转换的参数的大小。

一个基本的转换规范仅包含百分号和一个类型字符。 例如，%s 指定一个字符串转换。 若要打印百分号字符，请使用 %%。 如果百分号后跟一个没有任何意义的字符作为格式字段，则将调用无效的参数处理程序。 有关详细信息，请参阅 参数验证。

重要

为了保证安全性和稳定性，请确保格式转换规范字符串不是最终用户定义的。 例如，考虑这样一个程序，它提示用户输入名称并将输入存储在一个名为 user_name 的字符串变量中。 若要打印 user_name，请永远不要这样做：

printf( user_name ); /* Danger! If user_name contains "%s", program will crash */

而应执行以下操作：

printf( "%s", user_name );

备注

在 Visual Studio 2015 中，printf 函数和 scanf 函数系列已声明为 inline 并移至 和 标头。 如果正在迁移较旧的代码，则可能会发现 LNK2019 与这些函数相关。 有关详细信息，请参阅 Visual C++ 更改历史记录 2003 - 2015。

类型转换说明符字符指定是否要将相应的参数解释为字符、字符串、指针、整数或浮点数。 类型字符是唯一必填的转换规范字段，它出现在任何可选字段之后。

格式字符串后面的参数根据相应的 类型 字符和可选 大小 前缀进行解释。 通过使用 c 或 C，指定字符类型 char 和 wchar_t 的转换，通过使用 s 或 S 指定单字节和多字节或宽字符字符串，具体取决于正在使用的格式设置函数。 通过使用 c 和 s 指定的字符和字符串自变量被 printf 系列函数解释为 char 和 char*，或被 wprintf 系列函数解释为 wchar_t 和 wchar_t*。 通过使用 C 和 S 指定的字符和字符串自变量被 printf 系列函数解释为 wchar_t 和 wchar_t*，或被 wprintf 系列函数解释为 char 和 char*。 此行为是 Microsoft 专用的。 出于历史原因，wprintf函数使用 c 和 s 来wchar_t引用字符，并CS指定窄字符。

通过使用 d、i、o、u、x 和 X 指定整数类型（如 short、int、long、long long）以及其 unsigned 变体。 通过使用 a、A、e、E、f、F、g 和 G 指定浮点类型（如 float、double 和 long double）。 默认情况下，除非由大小前缀进行修改，否则整数参数将被强制为 int 类型，浮点参数将被强制为 double。 在 64 位系统上，int是一个 32 位值;因此，64 位整数的格式设置为输出时将被截断，除非使用 或 I64的大小前缀ll。 由 p 指定的指针类型使用平台的默认指针大小。

备注

Microsoft 专用： 与 printf 和 wprintf 函数一起使用时，Z 类型字符以及 c、C、s 和 S 类型字符的行为是 Microsoft 扩展。 在所有的格式设置函数中，ISO C 标准始终对窄字符和字符串使用 c 和 s，而对宽字符和字符串使用 C 和 S。

通用 C 运行时 (UCRT) UCRT 中存在一个已知问题，目前为了保持兼容性。 S与说明符一样，使用窄打印函数 (（如 printf) ANSI_STRING）时，Z没有大小修饰符前缀的说明符引用 UNICODE_STRING ，在使用宽打印函数 (（如) ）wprintf时引用 。 而不是 Z，使用 hZ 指定 ANSI_STRING。 wZ (或 lZ) 仍可用于指定 UNICODE_STRING。

通常情况下，Z 类型字符仅在使用转换规范的驱动程序调试函数（如 dbgPrint 和 kdPrint）中使用。

在 Visual Studio 2015 及更高版本中，如果与浮点转换说明符 (a、、A、e、 GEfFg、) 对应的参数是无限的、无限期的或 NaN 的，则格式化输出符合 C99 标准。 下表列出了格式化的输出：

这些字符串中的任何一个都可以以符号为前缀。 如果浮点类型转换说明符字符是一个大写字母，则输出也将使用大写字母格式。 例如，如果格式说明符是 %F而不是 %f，则 infinity 的格式将被设置为 INF，而不是 inf。 scanf 函数也可以分析这些字符串，使这些值可以通过 printf 和 scanf 函数进行往返。

在 Visual Studio 2015 之前，CRT 使用一种不同的非标准格式作为无穷大、不定和 NaN 值的输出：

这些字符串中的任何一个可能都以符号为前缀，并且可能根据字段宽度和精度以不同的方式设置格式，有时会产生异常的影响。 例如，printf("%.2f\n", INFINITY) 可以打印 1.#J，因为 #INF 会“四舍五入”到 2 位数的精度。

备注

如果与 %s 或 %S 对应的参数，或与 %Z 对应的参数的 Buffer 字段为空指针，则将显示“(null)”。

备注

在所有的指数格式中，要显示的指数的位数最少为两位，仅在必要时使用三位。 通过使用 _set_output_format 函数，可以将显示的数字位数设置为三位，以确保与为 Visual Studio 2013 及更早版本编写的代码的后向兼容性。

重要

%n 格式在本质上是不安全的，因此它默认处于禁用状态。 如果在 %n 格式字符串中遇到 ，则调用无效参数处理程序，如 参数验证中所述。 要启用 %n 支持，请参阅_set_printf_count_output。

转换规范中的第一个可选字段包含 标志指令。 此字段包含零个或多个标志字符，这些字符指定输出理由并控制符号、空白、前导零、小数点以及八进制和十六进制前缀的输出。 转换规范中可能会出现多个标志指令，并且标志字符可能会按任意顺序出现。

与 c、d、i、u 或 s 一起使用时忽略。

在转换规范中，可选宽度规范字段出现在任何标志字符之后。 width 参数是控制最小输出字符数量的非负十进制整数。 如果输出值中的字符数小于指定宽度，则将在值的左侧或右侧添加空白（具体取决于是否指定了左对齐标志 (-)），直到达到最小宽度为止。 如果 width 的前缀为 0，则将向整数或浮点转换添加前导零，直到到达最小宽度，但转换到无穷大或 NaN 时除外。

宽度规范永远不会导致值被截断。 如果输出值中的字符数大于指定宽度，或如果未提供 width，则将根据精度规范输出值中的所有字符。

如果宽度规范是一个星号 (*)，则参数列表中的 int 参数将提供此值。 width 参数前必须是已在参数列表中进行格式设置的值，如以下示例所示：

printf("%0*d", 5, 3); /* 00003 is output */

转换规范中缺少 width 值或此值较小将不会导致截断输出值。 如果转换结果宽于 width 值，则字段将扩展以包含转换结果。

在转换规范中，第三个可选字段是精度规范。 它包含一个句点 (.)，后跟一个非负十进制整数，指定字符串字符数、小数位数或要输出的有效数字位数，具体取决于转换类型.

与宽度规范不同的是，精度规范可能导致输出值截断或浮点值舍入。 如果 precision 被指定为 0 且要转换的值为 0，则结果为无字符输出，如以下示例中所示：

printf( "%.0d", 0 ); /* No characters output */

如果精度规范是一个星号 (*)，则参数列表中的某个 int 参数将提供此值。 在参数列表中，precision 参数前必须先于已格式设置的值，如以下示例所示：

printf( "%.*f", 3, 3.14159265 ); /* 3.142 output */

省略 precision 时，type 字符决定 precision 的解释或默认精度，如下表所示。

在转换规范中，大小字段是类型转换说明符的参数长度修饰符。 size 字段作为 type 字段（hh、h、j、l（小写的 L）、L、ll、t、w、z、I（大写的 i）、I32 和 I64）的前缀，根据它们修饰的转换说明符，指定对应参数的“大小”（长型或短型、32 位或 64 位、单字节字符或宽字符）。 这些大小前缀在 printf 和 wprintf 系列函数中与 类型 字符一起使用，以指定参数大小的解释（如下表中所示）。 大小字段对于某些参数类型是可选的。 未指定任何大小前缀时，格式化程序使用整数参数（例如，有符号或无符号的 char、short、int、long 和枚举类型）作为 32 位 int 类型，而使用 float、double 和 long double 浮点参数作为 64 位 double 类型。 此行为与变量自变量列表的默认自变量提升规则相匹配。 有关自变量提升的详细信息，请参阅后缀表达式中的“省略号和默认参数”。 在 32 位和 64 位系统上，64 位整数参数的转换规范必须包含 ll 或 I64 大小前缀。 否则，格式化程序的行为是不明确的。

某些类型在 32 位和 64 位代码中具有不同大小。 例如，size_t 在针对 x86 编译的代码中是 32 位长，而在针对 x64 编译的代码中是 64 位。 若要为宽度可变的类型创建与平台无关的格式设置代码，可以使用宽度可变的参数大小修饰符。 改为使用 64 位参数大小修饰符，并将宽度可变的参数类型显式提升为 64 位。 特定于 Microsoft 的 I（大写的 i）参数大小修饰符可处理宽度可变的整数参数，但我们建议使用特定于类型的 j、t 和 z 修饰符以确保可移植性。

ptrdiff_t 和 size_t 类型在 32 位平台上为 __int32 或 unsigned __int32，在 64 位平台上为 __int64 或 unsigned __int64。 I（大写的 i）、j、t 和 z 大小前缀采用平台的正确参数宽度。

在 Visual C++ 中，虽然 long double 是互异的类型，但是它具有与 double 相同的内部表示形式。

hc 或 hC 类型说明符与 printf 函数中的 c 以及 wprintf 函数中的 C 是同义的。 lc、lC、wc或 wC 类型说明符与 printf 函数中的 C 以及 wprintf 函数中的 c 是同义的。 hs 或 hS 类型说明符与 printf 函数中的 s 以及 wprintf 函数中的 S 是同义的。 ls、lS、ws 或 wS 类型说明符与 printf 函数中的 S 以及 wprintf 函数中的 s 是同义的。

备注

Microsoft 专用： I（大写的 i）、I32、I64 和 w 参数大小修饰符前缀是 Microsoft 扩展，且不符合 ISO C。 h 前缀（在与 char 类型的数据一起使用时）和 l（小写 L）前缀（在与 double 类型的数据一起使用时）是 Microsoft 扩展。

printf, _printf_l, wprintf, _wprintf_l printf_s, _printf_s_l, wprintf_s, _wprintf_s_l printf_p 位置参数